<!--
  ~ Copyright (C) 2010 Brockmann Consult GmbH (info@brockmann-consult.de)
  ~
  ~ This program is free software; you can redistribute it and/or modify it
  ~ under the terms of the GNU General Public License as published by the Free
  ~ Software Foundation; either version 3 of the License, or (at your option)
  ~ any later version.
  ~ This program is distributed in the hope that it will be useful, but WITHOUT
  ~ ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  ~ FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
  ~ more details.
  ~
  ~ You should have received a copy of the GNU General Public License along
  ~ with this program; if not, see http://www.gnu.org/licenses/
  -->

<html>
<head>
    <title>Sentinel Toolbox Help - GETASSE30 Elevation Model</title>
    <link rel="stylesheet" href="../style.css">
</head>

<body>
<table class="header">
    <tr class="header">
        <td class="header">&nbsp;
            GETASSE30 Elevation Model</td>
        
    <td class="header" align="right"><a href="../general/overview/SnapOverview.html"><img src="../images/snap_header.jpg" border=0 ></a></td>
    </tr>
</table>


<h3>GETASSE30 Elevation Model</h3>

<p>
    GETASSE30 stands for <b>G</b>lobal <b>E</b>arth <b>T</b>opography <b>A</b>nd <b>S</b>ea <b>S</b>urface <b>E</b>levation
    at <b>30</b> arc second resolution. This elevation model is currently the default DEM of the Sentinel Toolbox and
    has kindly been provided to the development team by Marc Bouvet (marc.bouvet@esa.int) of ESA/ESRIN.
    This documentation is also by courtesy of Marc Bouvet.

<p>Because of its size, the Sentinel Toolbox installer will not automatically install the GETASSE30 DEM files. But at
    first use
    the Toolbox will offer to download the DEM for you. Alternatively the GETASSE30 dataset can be manually downloaded
    from the STEP home page at
    <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
        <param name="content" value="http://step.esa.int/auxdata/dem/GETASSE30">
        <param name="text" value="<html><u>http://step.esa.int/auxdata/dem/GETASSE30</u></html>">
    </object>
    .
    The size is about 300 MB zipped and 2.3 GB unzipped. Due to the file size, we recommend this only if your internet
    connection is fast enough. If you like to install by yourself, please follow the instructions given here:
    <ol>
        <li>Download <code>GETASSE30.zip</code> from the STEP home page.</li>
        <li>Create directory <code>${USER_HOME}/.snap/auxdata/dem/GETASSE30</code></li>
        <li>The simplest way is unzip the <code>GETASSE30.zip</code> and copy the files into
<p><code>${USER_HOME}/.snap/auxdata/dem/GETASSE30/</code>.</p>
            The DEM is now installed.</li>
    </ol>

    <p>
        If you like to share the DEM along multiple Sentinel Toolbox installations in your network
        or if you simply don't want to install in the auxdata folder, then:
    </p>
    <ol start=4>
        <li>Copy the unzipped GETASSE30 dataset to a location accessible
            by your Sentinel Toolbox installation(s). This directory we call <code>${SHARED_GETASSE30}</code> from now on.</li>
        <li>Create a file named "dem.properties" in <code>${USER_HOME}/.snap/auxdata/dem/GETASSE30/</code> and open the
            new file in a text editor. <br>
            Add the following line <p><code>dem.installDir = ${SHARED_GETASSE30}</code></p> to it and don't forget to
            replace
            <code> ${SHARED_GETASSE30}</code> by your actual, shared DEM installation path. The properties file format
            requires to esacpe the backspace and colon characters using a backslash. Hence, on windows systems you'll
            have
            to escape the drive colon and file separator, e.g. <p><code>dem.installDir =
                P\:\\Data\\DEMs\\GETASSE30</code>.</p>
            The DEM is now installed.
        </li>
    </ol>
<p></p>

<h4>The GETASSE30 Data Set</h4>

<p>
    GETASSE30 is a composite of four other DEM datasets. It is using the SRTM30 dataset, ACE dataset, Mean Sea Surface
    (MSS) data and the
    EGM96 ellipsoid as sources. The resulting GETASSE30 dataset represents the Earth Topography And Sea Surface
    Elevation
    with respect to the WGS84 ellipsoid at 30 arc second resolution. The dataset has no missing values, but at the
    junction
    of the arctic and antarctic continents there are some tens of strange negative values (down to -700 m) inherent to
    the ACE dataset. All latitude/longitude values refer to the center of a pixel, not to one of its corners.
    The GETASSE30 dataset is organised as multiple tiles. Each tile is stored in associated file which can be imported
    into the Sentinel Toolbox using the <a href="ImportGETASSE30.html">GETASSE30 Reader</a>.
    (This reader is also internally used by the <a href="OrthorectificationAlgo.html">Orthorectification</a> algorithm.)
</p>

<p align="center"> <img src="images/GETASSE30Example.jpg" border=0 width="300" height="300"><br>
    Example of a GETASSE30 tile
</p>

<h4>The GETASSE30 Data</h4>
<ol type="I">
    <li>Mean sea surface height over sea and height over land, both referenced to the WGS84 ellipsoid.
    <table>
        <tr><td>Resolution:</td><td>30 arc second latitude and longitude</td></tr>
        <tr><td>Unit:</td><td>meter</td></tr>
        <tr><td>File name example:</td><td>45S045W.GETASSE30 where the first number is the latitude of the most
            South West pixel and the second number its longitude</td></tr>
        <tr><td>Data format:</td><td>binary, 1800*1800 signed 16-bit integer values, big endian order</td></tr>
    </table>
</ol>

<p align="center"> <img src="images/GETASSE30ElevationData.jpg" border=0 width="636" height="318"><br>
    The GETASSE30 elevation data
</p>
<br>
There are 5 types of values:
<ol>
    <li>Over land, between 60N and -60S, where SRTM30 DEM data are available, the
        output value is the sum of SRTM30 elevation and the EGM96 geoid height.</li>
    <li>Over land, between 60N and -60S, where SRTM30 DEM data are not available, the
        output value is the sum of ACE elevation and the EGM96 geoid height.</li>
    <li>Over land, above 60N and -60S, where ACE data are available, the output value is the sum of
        ACE elevation and the EGM96 geoid height.</li>
    <li>Over sea, where neither ACE DEM nor SRTM30 data are not available, if MSS data are available,
        then the output value is the MSS.</li>
    <li>Over sea, where neither ACE DEM nor SRTM30 data are not available, if MSS data are not available,
        then the output value is the EGM96 value.</li>
</ol>
<li>Flag
    <ul>
        <li>Pixels described as in 2) and 3) are flagged with the value 0</li>
        <li>Pixels described as in 3) are flagged with the value 1</li>
        <li>Pixels described as in 4) are flagged with the value 2</li>
        <li>Pixels described as in 1) are flagged with the value 3</li>
    </ul>
    <table>
        <tr><td>Resolution:</td><td>30 arc second latitude and longitude</td></tr>
        <tr><td>Unit:</td><td>none</td></tr>
        <tr><td>File name example:</td><td>45S045W.GETASSE30_flag where the first number is the latitude of the most
            South West pixel and the second number its longitude</td></tr>
        <tr><td>Data format:</td><td>binary, 1800*1800 unsigned 8-bit integer values, big endian order</td></tr>
    </table>

    
  <p align="center"> <img src="images/GETASSE30Flags.jpg" border=0 width="664" height="331"><br>
        The flag associated to the GETASSE30 data
    </p>
</li>

<h4>Input Data used in GETASSE30 Generation</h4>
<ul>
    <li>ACE DEM at 30 arc second resolution referenced to the EGM96 geoid<br>
        See ACE Report at 
        <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">     
            <param name="content" value="http://www.cse.dmu.ac.uk/geomatics/products_ace_overview.html">
            <param name="text" value="<html><u>http://www.cse.dmu.ac.uk/geomatics/products_ace_overview.html</u></html>">
    </object>
    </li>
    <li>SRTM30 data are reference to the EGM96 geoid<br>
        See 
        <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">     
            <param name="content" value="http://www2.jpl.nasa.gov/srtm/">
            <param name="text" value="<html><u>http://www2.jpl.nasa.gov/srtm/</u></html>">
        </object></li>
    <li>Mean Sea Surface (MSS) height at 2 minutes resolution referenced to the WGS84 ellipsoid.<br>
        From the RA2 auxilliary file RA2_MSS_AXVIEC20031208_145545_20020101_000000_20200101_000000<br>
        See RA2 product handbook at 
        <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">     
            <param name="content" value="http://www.envisat.esa.int">
            <param name="text" value="<html><u>http://www.envisat.esa.int</u></html>">
        </object></li>
</ul>

<hr>
</body>
</html>